Cisco DNA Upgrading

Upgrading Packages Individually

If you chose to install packages individually, you must install the packages in the following order depending on if you use Automation or Assurance.

Before you begin

The preferred method of upgrading DNA Center is explained in Upgrading to Cisco DNA Center, Release 1.1.8. However, you can also install packages individually after you have installed the system updates.

Be sure you have the username and password for at least one cisco.com user account. You might be prompted, once, for the credentials during package installation. This can be any valid cisco.com user account.

Procedure


Step 1Install the system update as explained in Step 1 to Step 7 in Upgrading to Cisco DNA Center, Release 1.1.8.
Step 2From the DNA Center home page, choose  > System Settings > App Management > Packages & Updates.
Step 3Install the packages one at a time, depending on if you use Automation or Assurance in one of the following two tables.Note Packages that have available updates appear automatically. If a package does not appear in the Available Version column, skip it and install the next package in the following sequence.Table 2. System Upgrade Installation Order for AutomationInstallation OrderPackage Name in GUI1Package Name in CLI21NCP – Basencp-system2NCP – Servicesautomation-core3Network Controller Platformnetwork-visibility4Automation – Image Managementimage-management5Command Runnercommand-runner6Automation – Device Onboardingdevice-onboarding7Assurance – Path Tracepath-trace8Automation – Basebase-provision-core9Automation – SD Accesssd-access10Automation – Sensorsensor-automation11Automation – Application Policyapplication-policy1 GUI name refers to the package name as shown in Settings > System Settings > App Management.2 CLI name refers to the package name as shown in maglev package status output.
Step 4If you use Assurance only, from the DNA Center home page, click the gear icon () and choose System Settings > App Management > System Updates, and then upgrade System.Note Download and install System from the System Updates page only. Even if System appears on the Packages & Updates page, do not download or install it from that page. Use the System Updates page only.
Step 5From the DNA Center home page, click the gear icon () and choose System Settings > App Management > Packages & Updates, and install the packages one at a time in the order shown in the following table.Table 3. System Upgrade Installation Order for Assurance OnlyInstallation OrderPackage1Network Data Platform – Core (ndp-platform)2Network Data Platform – Base Analytics (ndp-base-analytics)3Network Data Platform – Manager (ndp-ui)4Assurance – Base (assurance)5Assurance – Sensor (sensor-assurance)For the IP-based access control feature, you must install the following packages in the order specified:Network Control PlatformAutomation – BaseIf you previously installed SD Access, at a minimum, you must upgrade the following packages in the order specified:Network Controller PlatformAutomation – BaseAutomation – SD Access

Recovering From Premature Package Downloads

Successful migration to this release requires that you install all system updates before downloading or installing application package updates. Due to dependencies among the updates, failure to observe this rule can make it impossible to install both system updates and package updates. Problem indicators include messages that a system update has failed and package update downloads that never exit the “Downloading” state.

As an admin user with Maglev SSH access privileges, complete the following steps to recover and install the system update.

Procedure


Step 1Using an SSH client, log in to the DNA Center appliance using the IP address of the out-of-band management network adapter, on port 2222. Use the maglev login command and log in with an admin username and password (which is the same login used for the admin user on the DNA Center UI).
Step 2At the command line, delete all prematurely downloaded package updates by entering the following command:$ for pkg in $(maglev package status -o json | jq -r '.[] | select(.available!="-") | [ .name,.available | tostring ] | join (":")'); do maglev catalog package delete $pkg 2>/dev/null; done
Step 3Trigger the downloaded system update from the DNA Center UI.
Step 4After the system update installs successfully, download and install package updates.